home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / desktop / dviwin29.zip / README < prev    next >
Text File  |  1994-12-01  |  15KB  |  280 lines
  1. 12/1/94
  2. =======
  3.  
  4. This is the distribution for DVIWIN 2.9 which is a DVI driver for previewing
  5. and printing DVI files under MS-Windows 3.1 and Windows NT. The following
  6. steps will help you install the program as quickly as possible. You CAN use
  7. both versions under Windows 3.1 or Windows NT, but I would suggest that you
  8. use the 16-bit version under Windows 3.1 or Win-OS/2, and the 32-bit version
  9. under Windows NT. Both versions SHOULD also run without problems under
  10. Chicago, but neither has been tested under that system.
  11.  
  12. ===========================================================================
  13. I. Installing the 16-bit version
  14. ===========================================================================
  15.  
  16. 1. Basic program setup
  17.    a. Copy the files dviwin.exe, wbr.exe, clipmeta.exe, dde2exe.exe,
  18.       miscwin.dll, graphio.dll, dviwin.str, wbr.str, clipmeta.str,
  19.       genpk.bat, genpk.pif, genall.bat, genall.pif, dviwin.hlp and
  20.       wbr.hlp to any directory in your path. Copy the file ctl3dv2.dll
  21.       to the windows\system directory.
  22.    b. Add a section in win.ini about the graphics filters. The section
  23.       should look like:
  24.          [MS Graphic Import Filters]
  25.          PC Paintbrush(.PCX)=XXXXXX\pcxin.flt,PCX
  26.          Microsoft Paint(.MSP)=XXXXXX\mspin.flt,MSP
  27.          Bitmaps(.BMP)=XXXXXX\bmpin.flt,BMP
  28.          Bitmaps(.DIB)=XXXXXX\bmpin.flt,DIB
  29.          Bitmaps(.RLE)=XXXXXX\bmpin.flt,RLE
  30.          Compuserve GIF(.GIF)=XXXXXX\gifin.flt,GIF
  31.          X Pixmaps(.XPM)=XXXXXX\xpmin.flt,XPM
  32.       where XXXXXX is the name of the directory where you want to
  33.       store the filters. Then place the five filters (pcxin.flt, mspin.flt,
  34.       bmpin.flt, gifin.flt and xpmin.flt) in the specified directory.
  35.    c. Make an entry in a Program Manager group and specify the command line
  36.       as: "dviwin.exe -1"
  37.    d. Make new entries in one of your Program Manager groups for the two
  38.       other programs (wbr.exe and clipmeta.exe).
  39.  
  40. 2. Font setup
  41.    a. You can use FLI files by placing them in any directory and specifying
  42.       the directory name in the "Font Directory" entry in the Options menu.
  43.    b. Alternatively, you can use PK files by storing them in separate
  44.       directories according to their resolution and specifying a template in
  45.       the "Font Directory" entry in the Options menu. In the template, the
  46.       sequence $r will be substituted by the actual resolution number at
  47.       runtime. If for example you store the PK files in the directories
  48.       "c:\texfonts\300", "c:\texfonts\360", etc., the template should be:
  49.       "c:\texfonts\$r"
  50.  
  51. 3. Metafont linkage for automatic generation of missing fonts
  52.    a. You first need a working copy of Metafont and gftopk.exe; these
  53.       can be obtained from the net. Follow the Metafont instructions
  54.       to install that program.
  55.    b. Follow the instructions in the comments of the file genpk.bat to
  56.       generate the plain base (which should include the information from
  57.       the file modes.mf).
  58.    c. Edit the first four statements in the file genpk.bat to tailor the
  59.       file to your directory setup.
  60.    d. Select the "Execute command" option from the "Missing Fonts" entry
  61.       in the "Options" menu of dviwin. The "Cmd." field should be:
  62.            genpk.pif /e:2048 /c genpk.bat $f $m $x $y $X $Y $d $p $e
  63.    e. The above option does not work properly under NT or OS/2. In
  64.       those cases, select the option "Append line to file and execute
  65.       command" from the "Missing Fonts" entry in the "Options" menu.
  66.       The "Line" field should be:
  67.            call genpk $f $m $x $y $X $Y $d $p $e
  68.       The "File" field should be:
  69.            $(TEMP)\missing.bat
  70.       The "Cmd." field should be:
  71.            genall.pif $(TEMP)\missing.bat
  72.  
  73. 4. Editor linkage for inverse search
  74.    Dviwin can interface with most text editors supporting the DDE protocol.
  75.    PFE is such an editor and is freely available from ftp.cica.indiana.edu.
  76.    The interface is accomplished by setting several fields in the "Inverse
  77.    Search" dialog from the "Options" menu. Set the "Command" field to
  78.    "pfe.exe $f", the "Service" field to "PFE", the "Topic" field to "System",
  79.    the "Message 1" field to "[FileOpen("$f")] [EditGotoLine($l,0)]
  80.    [EditSelectLine()]", leave the "Message 2" field empty, and check the
  81.    "Uses DDE" box (You'll need PFE version 0.05.007G or later). When you
  82.    double click the left mouse button, dviwin will instruct PFE to display
  83.    the appropriate TeX file at the appropriate location (provided of course
  84.    that the DVI file contains src specials). For more info on this, please
  85.    read the dviwin help file.
  86.  
  87. 5. Editor setup for forward search
  88.    You can also do a forward search (ie., find the location in the DVI file
  89.    that corresponds to a particular location in the TeX file) provided that
  90.    the DVI file contains src specials. Assuming that you use PFE, go to the
  91.    "Configure Windows Tools" dialog from the "Execute" menu, set the "Tool"
  92.    field to "Dviwin" and the "Command Line" field to:
  93.    dde2exe 'dviwin -1 -s\'' PFE|Editor!LineNumber ' ' PFE|Editor!FileName '\''
  94.    Once you load a TeX file, you will be able to do a forward search by
  95.    selecting the "Dviwin" tool from the "Launch Windows Tool" dialog in the
  96.    "Execute" menu. If the DVI file contains src specials, dviwin will
  97.    try to position you at the DVI location corresponding to the current
  98.    line number of the current file.
  99.  
  100. 6. External print linkage
  101.    Assuming that you want to use dvips (version 5.49 or later) for printing,
  102.    you can do the following steps:
  103.    a. Write a batch file called rundvips.bat containing the lines:
  104.          dvips -p=%1 -l=%2 %4 %3
  105.          copy %3.ps prn /b
  106.          del %3.ps
  107.    b. Make a PIF file called rundvips.pif for the above batch file
  108.    c. Go to the Print dialog from the File menu, specify the external
  109.       print template as:
  110.          rundvips.pif $1 $2 $b $R-r
  111.       and check the "Enable" box.
  112.  
  113. ===========================================================================
  114. II. Installing the 32-bit version
  115. ===========================================================================
  116.  
  117. 1. Basic program setup
  118.    a. Copy the files dviwin2.exe, wbr2.exe, clipmet2.exe, dde2exe2.exe,
  119.       miscwin2.dll, graphio2.dll, dviwin.str, wbr.str, clipmeta.str,
  120.       genpk.bat, genpk.pif, genall.bat, genall.pif, dviwin.hlp and wbr.hlp
  121.       to any directory in your path. Copy the file ctl3d32.dll to the
  122.       windows\system directory (or windows\system32 under NT). Note that
  123.       all 32-bit executables are inside the file "dviwin32.zip", so you
  124.       will need to unzip that file first.
  125.    b. Add a section in win.ini about the graphics filters. The section
  126.       should look like:
  127.          [NT Graphic Import Filters]
  128.          PC Paintbrush(.PCX)=XXXXXX\pcxin2.flt,PCX
  129.          Microsoft Paint(.MSP)=XXXXXX\mspin2.flt,MSP
  130.          Bitmaps(.BMP)=XXXXXX\bmpin2.flt,BMP
  131.          Bitmaps(.DIB)=XXXXXX\bmpin2.flt,DIB
  132.          Bitmaps(.RLE)=XXXXXX\bmpin2.flt,RLE
  133.          Compuserve GIF(.GIF)=XXXXXX\gifin2.flt,GIF
  134.          X Pixmaps(.XPM)=XXXXXX\xpmin2.flt,XPM
  135.       where XXXXXX is the name of the directory where you want to
  136.       store the filters. Then place the five filters (pcxin2.flt, mspin2.flt,
  137.       bmpin2.flt, gifin2.flt and xpmin2.flt) in the specified directory.
  138.    c. Make an entry in a Program Manager group and specify the command line
  139.       as: "dviwin2.exe -1"
  140.    d. Make new entries in one of your Program Manager groups for the two
  141.       other programs (wbr2.exe and clipmeta2.exe).
  142.  
  143. 2. Font setup
  144.    a. You can use FLI files by placing them in any directory and specifying
  145.       the directory name in the "Font Directory" entry in the Options menu.
  146.    b. Alternatively, you can use PK files by storing them in separate
  147.       directories according to their resolution and specifying a template in
  148.       the "Font Directory" entry in the Options menu. In the template, the
  149.       sequence $r will be substituted by the actual resolution number at
  150.       runtime. If for example you store the PK files in the directories
  151.       "c:\texfonts\300", "c:\texfonts\360", etc., the template should be:
  152.       "c:\texfonts\$r"
  153.  
  154. 3. Metafont linkage for automatic generation of missing fonts
  155.    a. You first need a working copy of Metafont and gftopk.exe; these
  156.       can be obtained from the net. Follow the Metafont instructions
  157.       to install that program.
  158.    b. Follow the instructions in the comments of the file genpk.bat to
  159.       generate the plain base (which should include the information from
  160.       the file modes.mf).
  161.    c. Edit the first four statements in the file genpk.bat to tailor the
  162.       file to your directory setup.
  163.    d. Select the "Execute command" option from the "Missing Fonts" entry
  164.       in the "Options" menu of dviwin. The "Cmd." field should be:
  165.            genpk.pif /e:2048 /c genpk.bat $f $m $x $y $X $Y $d $p $e
  166.    e. The above option does not work properly under 16-bit Windows. In
  167.       those cases, select the option "Append line to file and execute
  168.       command" from the "Missing Fonts" entry in the "Options" menu.
  169.       The "Line" field should be:
  170.            call genpk $f $m $x $y $X $Y $d $p $e
  171.       The "File" field should be:
  172.            $(TEMP)\missing.bat
  173.       The "Cmd." field should be:
  174.            genall.pif $(TEMP)\missing.bat
  175.  
  176. 4. Editor linkage for inverse search
  177.    Dviwin can interface with most text editors supporting the DDE protocol.
  178.    PFE is such an editor and is freely available from ftp.cica.indiana.edu.
  179.    The interface is accomplished by setting several fields in the "Inverse
  180.    Search" dialog from the "Options" menu. Set the "Command" field to
  181.    "pfe32.exe $f", the "Service" field to "PFE32", the "Topic" field to
  182.    "System", the "Message 1" field to "[FileOpen("$f")] [EditGotoLine($l,0)]
  183.    [EditSelectLine()]", leave the "Message 2" field empty, and check the
  184.    "Uses DDE" box (You'll need the 32-bit version of PFE version 0.05.007G
  185.    or later). When you double click the left mouse button, dviwin will
  186.    instruct PFE to display the appropriate TeX file at the appropriate
  187.    location (provided of course that the DVI file contains src specials).
  188.    For more info on this, please read the dviwin help file.
  189.  
  190. 5. Editor setup for forward search
  191.    You can also do a forward search (ie., find the location in the DVI file
  192.    that corresponds to a particular location in the TeX file) provided that
  193.    the DVI file contains src specials. Assuming that you use PFE, go to the
  194.    "Configure Windows Tools" dialog from the "Execute" menu, set the "Tool"
  195.    field to "Dviwin" and the "Command Line" field to:
  196.    dde2exe2 'dviwin2 -1 -s\'' PFE32|Editor!LineNumber ' ' PFE32|Editor!FileName '\''
  197.    Once you load a TeX file, you will be able to do a forward search by
  198.    selecting the "Dviwin" tool from the "Launch Windows Tool" dialog in the
  199.    "Execute" menu. If the DVI file contains src specials, dviwin will
  200.    try to position you at the DVI location corresponding to the current
  201.    line number of the current file.
  202.  
  203. 6. External print linkage
  204.    Assuming that you want to use dvips (version 5.49 or later) for printing,
  205.    you can do the following steps:
  206.    a. Write a batch file called rundvips.bat containing the lines:
  207.          dvips -p=%1 -l=%2 %4 %3
  208.          copy %3.ps prn /b
  209.          del %3.ps
  210.    b. Make a PIF file called rundvips.pif for the above batch file
  211.    c. Go to the Print dialog from the File menu, specify the external
  212.       print template as:
  213.          rundvips.pif $1 $2 $b $R-r
  214.       and check the "Enable" box.
  215.  
  216. ===========================================================================
  217. III. Some more steps...
  218. ===========================================================================
  219.  
  220. 1. Read or print the documentation files "whats.new", "dviwin.wri"
  221.    and "helpme.wri". There are several changes in this version,
  222.    so please read these files.
  223.  
  224. 2. If you want to inspect or modify the source code of the graphics
  225.    filters, unzip the file "graphio.zip" using the "-d" switch in
  226.    pkunzip and read the "readme" files for each directory.
  227.  
  228. 3. Make sure that you have a statement "FILES=50" (or more) in your
  229.    config.sys file.
  230.  
  231. The following 3 steps apply only if you are doing an initial installation:
  232.  
  233. 4. The first time that you run "dviwin.exe", go to the "Font Directory"
  234.    entry in the "Options" submenu and specify the base directory for
  235.    your fonts followed by \$r. In the above example, the font directory
  236.    entry should be "c:\tex\pkfonts\$r". If this step is not done, you will
  237.    see NOTHING.
  238.  
  239. 5. You will also need a collection of PK font files in various
  240.    resolutions; many such files can be found in the SIMTEL archives
  241.    or any of its mirrors. In general, you want to get at least printer
  242.    fonts, and optionally screen fonts. as well as for your printer
  243.    Most (but not all) screen fonts are in the files "dvivga2.zip" through
  244.    "dvivga8.zip" in the directory pub/msdos/tex of oak.oakland.edu. When
  245.    you get these files, arrange them as following:
  246.  
  247.      a. Make a "base" directory (eg., c:\tex\pkfonts)
  248.      b. Make a subdirectory under the base directory for each resolution.
  249.         The name of each subdirectory should simply be the resolution.
  250.         For example, you can make the subdirectories "c:\tex\pkfonts\300",
  251.         "c:\tex\pkfonts\329", "c:\tex\pkfonts\360" for the 300 dpi, 329
  252.         dpi and 360 dpi resolutions respectively.
  253.      c. Put your PK font files in the correct subdirectories according
  254.         to their resolution.
  255.  
  256. 6. Using a resolution between 100 and 145 dpi, open and see the file
  257.    "demo.dvi". This was produced from the file "demo.tex" and it reads
  258.    the graphics file "demo.wmf". As you will see, it is very easy to
  259.    combine text and graphics using this driver. You can also print the
  260.    file by issuing the "Print" command from the "File" submenu.
  261.  
  262.  
  263. The following steps apply only if you are upgrading from dviwin 2.0:
  264.  
  265. 7. Go to the Options submenu and add the suffix \$r to your font
  266.    directory. Otherwise, the program will NOT be able to find any
  267.    PK fonts.
  268.  
  269. 8. If you use a font substitution file, change it according to the
  270.    new method (uses dpi instead of TeX magnifications). The new
  271.    file should be called "dviwin.sub" instead of "texfonts.sub";
  272.    there is a sample substitution file in this release.
  273.  
  274.  
  275. I hope that the above steps are clear. If there are any installation or
  276. operation problems, please let me know.
  277.  
  278. Hippocrates Sendoukas
  279. isendo@leon.nrcps.ariadne-t.gr
  280.